/**
 * @(#)${NAME}.java Mar 12, 2007
 *
 * Copyright (c) 2005-2010 Psiqueware S.A. de C.V. All Rights Reserved.
 * This software is the proprietary information Psiqueware S.A. de C.V.
 * Use is subject to license terms.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
 * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
 * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 *
 * <br/>Usuario : Psique
 * <br/>Creaci&oacute;n: Mar 12, 2007 - 11:24:26 AM
 * <br/>
 * <br/>
 * <br/><t5>Cambios :</t5>
 * <br/><b>Fecha | Autor  |  Cambios</b>
 * <ul>
 * <li>Mar 12, 2007 | <a href = "mailto:AngelElectrico@PsiqueWare.com">Psique</a> | Creaci&oacute;n del Objeto.</li>
 *
 * </ul>
 */

package com.psiqueware.jazmin.empresas.recursos.materiales.dao.hbm;

import com.psiqueware.alheli.dao.DAOException;
import com.psiqueware.alheli.dao.EnlaceTransaccional;
import com.psiqueware.alheli.dao.hibernate.BaseDAOHibernateA;
import com.psiqueware.alheli.dao.hibernate.HibernateService;
import com.psiqueware.jazmin.empresas.recursos.materiales.Ubicacion;
import com.psiqueware.jazmin.empresas.recursos.materiales.dao.UbicacionDAO;
import com.psiqueware.jazmin.empresas.recursos.materiales.modelo.UbicacionK;
import com.psiqueware.tulipan.organizacional.Estructura;

import java.util.ArrayList;
import java.util.List;

/**
 * Acceso de operaciones CRUD para el objeto UbicacionK basado en Hibernate A.
 * <br/>Paquete Original: com.psiqueware.laVIE.empresas.dao.hbm
 * <br/>Nombre  Original: UbicacionDAOHbmA
 * <br/>Oprima para ver : <a href="UbicacionDAOHbmA.java.html"><i>C&oacute;digo Fuente</i> </a>
 *
 * @author <a href="mailto:AngelElectrico@PsiqueWare.com">Psique</a>
 * @version Revision: 1.1 Mar 5, 2007 11:04:21 AM
 * @noinspection DuplicateStringLiteralInspection,CastToConcreteClass,ClassWithoutToString,ClassWithoutLogger
 */
public class UbicacionDAOHbmA extends BaseDAOHibernateA implements UbicacionDAO
{

    /** Clase que realizar&aacute; las operaciones. */
    private HibernateService<UbicacionK> m_orm = new HibernateService<UbicacionK> ( UbicacionDAOHbmA.class );

    /** Constructor de UbicacionDAOHbmA. */
    public UbicacionDAOHbmA ()
    {

    }

    /**
     * Guarda un {@link Ubicacion} en persistencia.
     * Este {@link Ubicacion} no debe existir en persistencia o una
     * AlreadyPersistedObjectException debe brotar.
     *
     * @param o                   UbicacionK a persistir.
     * @param enlaceTransaccional enlace para hacer at&oacute;micas las transacciones.
     *
     * @return UbicacionK despu&eacute;s de persistirse.
     *         Una com.psiqueware.basico.dao.AlreadyPersistedObjectException surgir&aacute;
     *         en caso de que este {@link Ubicacion} ya existiera en persistencia.
     *
     * @exception com.psiqueware.alheli.dao.DAOException
     *
     */
    public Ubicacion saveUbicacion ( Ubicacion o, EnlaceTransaccional enlaceTransaccional ) throws DAOException
    {
        return m_orm.save ( ( UbicacionK ) o, enlaceTransaccional );

    }

    /**
     * Actualiza un {@link Ubicacion} en persistencia
     *
     * @param o                   Ubicacion a actualizar
     * @param enlaceTransaccional enlace para hacer at&oacute;micas las transacciones.
     *
     * @return {@link Ubicacion} actualizado
     *         Una NotAPersistedObjectException surgir&aacute;
     *         en caso de que este {@link Ubicacion} no existiera en persistencia.
     *
     * @exception com.psiqueware.alheli.dao.DAOException
     *
     */
    public Ubicacion updateUbicacion ( Ubicacion o, EnlaceTransaccional enlaceTransaccional ) throws DAOException
    {
        return m_orm.update ( ( UbicacionK ) o, enlaceTransaccional );
    }

    /**
     * Devuelve un {@link Ubicacion} a partir de su id.
     *
     * @param id                  del {@link Ubicacion} que se busca
     * @param enlaceTransaccional enlace para hacer at&oacute;micas las transacciones.
     *
     * @return {@link Ubicacion} en caso de encontrarlo, <code>null</code> en otro caso.
     *
     * @exception com.psiqueware.alheli.dao.DAOException
     *             si se presenta alg&uacute;n problema.
     */
    public Ubicacion findUbicacionPorId ( Long id, EnlaceTransaccional enlaceTransaccional ) throws DAOException
    {
        return m_orm.findPorId ( UbicacionK.class, id, enlaceTransaccional );
    }

    /**
     * Eliminar un {@link Ubicacion} del sistema de persistencia.
     *
     * @param o                   Ubicacion que se pretende elimninar.
     * @param enlaceTransaccional enlace para hacer at&oacute;micas las transacciones.
     *                            Una NotAPersistedObjectException surgir&aacute; si dicho objeto no exist&iacute;a en persistencia.
     *
     * @exception com.psiqueware.alheli.dao.DAOException
     *             si no se puede comunicar a la base de datos.
     */
    public void deleteUbicacion ( Ubicacion o, EnlaceTransaccional enlaceTransaccional ) throws DAOException
    {
        m_orm.delete ( ( UbicacionK ) o, enlaceTransaccional );
    }

    /**
     * Devuelve un listado de los {@link Ubicacion} que se encuentran en persistencia.
     *
     * @param enlaceTransaccional enlace para hacer at&oacute;micas las transacciones.
     *
     * @return List de {@link Ubicacion} en caso de encontrarlo, una lista vacia en caso contrario.
     *
     * @exception com.psiqueware.alheli.dao.DAOException
     *             si se presenta alg&uacute;n problema.
     */
    public List<Ubicacion> listUbicacion ( EnlaceTransaccional enlaceTransaccional ) throws DAOException
    {
        return new ArrayList<Ubicacion> ( m_orm.queryList ( "FROM " + UbicacionK.class.getCanonicalName (), enlaceTransaccional ) );
    }

    /**
     * Devuelve un listado de los {@link Ubicacion} que se encuentran en persistencia registrados para la estructura.
     *
     * @param enlaceTransaccional enlace para hacer at&oacute;micas las transacciones.
     * @param estructura             donde se busca.
     *
     * @return List de {@link Ubicacion} en caso de encontrarlo, una lista vacia en caso contrario.
     *
     * @exception com.psiqueware.alheli.dao.DAOException
     *             si se presenta alg&uacute;n problema.
     */
    public List<Ubicacion> listUbicacionPorEstructura ( final Estructura estructura, final EnlaceTransaccional enlaceTransaccional ) throws DAOException
    {

        return new ArrayList<Ubicacion> ( m_orm.queryList ( "FROM " + UbicacionK.class.getCanonicalName () +
                " AS U WHERE U.idEstructura=" + estructura.getId (), enlaceTransaccional ) );
    }
}

